ResultsRecord

#include

typedef struct ResultsRecord { Size Offset Description

short numRows; 2 0 number of rows in result

short numCols; 2 2 number of columns per row

Handle colTypes; 4 4 data type array

Handle colData; 4 8 actual results

The numRows field in the ResultsRecord indicates the total number of rows

retrieved. If the DBGetQueryResults function returns a result code other

than rcDBValue, then not all of the data actually returned by the data source

was retrieved. This could happen, for instance, if the user's computer does not

have sufficient memory space to hold all the data. In this case, your application

can make more space available (by writing the data in the data record to disk,

for example) and then call the DBGetQueryResults function again to

complete retrieval of the data.

Note: The DBGetQueryResults function retrieves whole rows

only; if it runs out of space in the middle of a row, it stores the

partial row in a private buffer so that the data in the

ResultsRecord ends with the last complete row. Because the last

partial row is no longer available from the data server, you cannot

start to retrieve data with the DBGetQueryResults function and

then switch to the DBGetItem function to complete the data

retrieval.

The numCols field indicates the number of columns in each row of data.

The colTypes field is a handle to an array of data types, specifying the type of

data in each column. The number of elements in the array is equal to the value

in the numCols parameter.

The colData field is a handle to the data retrieved by the

The colInfo field is a handle to an array of records of type

DBColInfoRecord, each of which specifies the length, places, and flags for a

data item. There are as many records in the array as there are data items

retrieved by the DBGetQueryResults function.

Referenced by (7):